MPNotifyQueue

MPNotifyQueue
Header:	Multiprocessing.h		Carbon status:	Supported

Sends a message to the specified message queue.

OSStatus MPNotifyQueue (
    MPQueueID queue, 
    void *param1, 
    void *param2, 
    void *param3
);

queue: The queue ID of the message queue you want to notify.
param1: The first 32-bits of the message to send.
param2: The second 32-bits of the message to send.
param3: The third 32-bits of the message to send.

function result: A result code.

DISCUSSION

This function sends a message to the specified queue, which consist of the three parameters, param1, param2, and param3. The system does not interpret the three 32-bit words which comprise the text of the message. If tasks are waiting on the specified queue, the first waiting task is unblocked and the task’s MPWaitOnQueue function completes.

Depending on the queue mode, the system either allocates messages dynamically or assigns them to memory reserved for the queue. In either case, if no more memory is available for messages MPNotifyQueue returns kMPInsufficientResourcesErr.

You can call this function from an interrupt handler if messages are reserved on the queue. For more information about queueing modes and reserving messages, see MPSetQueueReserve.

Also see the function MPWaitOnQueue.

VERSION NOTES

Introduced with Multiprocessing Services 1.0.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when MPLibrary 1.0 or later is installed. Exported by CarbonLib 1.0 and later and by MPLibrary 1.0 and later.